<!--
  This file is a part of the open-eBackup project.
  This Source Code Form is subject to the terms of the Mozilla Public License, v. 2.0.
  If a copy of the MPL was not distributed with this file, You can obtain one at
  http://mozilla.org/MPL/2.0/.
  
  Copyright (c) [2024] Huawei Technologies Co.,Ltd.
  
  THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTIES OF ANY KIND,
  EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT,
  MERCHANTABILITY OR FIT FOR A PARTICULAR PURPOSE.
  -->

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html lang="en-us" xml:lang="en-us">
 <head>
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
  <meta http-equiv="X-UA-Compatible" content="IE=edge">
  <meta name="DC.Type" content="topic">
  <meta name="DC.Title" content="Step 1: Configuring the XBSA Library Path">
  <meta name="product" content="">
  <meta name="DC.Relation" scheme="URI" content="en-us_topic_0000002200012593.html">
  <meta name="prodname" content="">
  <meta name="version" content="">
  <meta name="brand" content="">
  <meta name="DC.Publisher" content="20250306">
  <meta name="prodname" content="csbs">
  <meta name="documenttype" content="usermanual">
  <meta name="DC.Format" content="XHTML">
  <meta name="DC.Identifier" content="EN-US_TOPIC_0000002200098125">
  <meta name="DC.Language" content="en-us">
  <link rel="stylesheet" type="text/css" href="public_sys-resources/commonltr.css">
  <title>Step 1: Configuring the XBSA Library Path</title>
 </head>
 <body style="clear:both; padding-left:10px; padding-top:5px; padding-right:5px; padding-bottom:5px">
  <a name="EN-US_TOPIC_0000002200098125"></a><a name="EN-US_TOPIC_0000002200098125"></a>
  <h1 class="topictitle1">Step 1: Configuring the XBSA Library Path</h1>
  <div>
   <p>Before backing up the Informix/GBase 8s database, you need to specify the path and file name of the XBSA shared library.</p>
   <div class="section">
    <h4 class="sectiontitle">Procedure</h4>
    <ol>
     <li><span>Use PuTTY to log in to the host where the Informix/GBase 8s database is located as user <strong>root</strong>.</span></li>
     <li id="EN-US_TOPIC_0000002200098125__li1650306175213"><span>For an Informix database, run the <strong id="EN-US_TOPIC_0000002200098125__b096445305220">su - informix</strong> command to switch to the Informix database user. For the GBase 8s database, run the <strong id="EN-US_TOPIC_0000002200098125__b4835175993915">su - gbasedbt</strong> command to switch to the GBase 8s database user.</span></li>
     <li><span>Run the following command to check whether the instance is configured:</span><p></p><pre class="screen">cat /<em>Database installation directory</em>/etc/onconfig |grep ^BAR_BSALIB_PATH</pre>
      <div class="note">
       <img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span>
       <div class="notebody">
        <p>Replace <strong>onconfig</strong> with the actual name of the instance configuration file.</p>
       </div>
      </div> <p>If the following information is displayed, the instance has been configured and no further action is required. Otherwise, proceed with the subsequent operations to configure the instance.</p> <p>For 1.5.0: Information similar to the following is displayed:</p> <pre class="screen">BAR_BSALIB_PATH /usr/openv/lib/libxbsa64iif.so</pre> <p>For 1.6.0 and later versions: Information similar to the following is displayed:</p> <pre class="screen">BAR_BSALIB_PATH /<em>Parent directory where the client is installed</em>/DataBackup/ProtectClient/interfaces/xbsa/lib/libxbsa64iif.so</pre> <p></p></li>
     <li><span>Run the following command to open the instance configuration file:</span><p></p><pre class="screen">vi /<em>Database installation directory</em>/etc/onconfig</pre> <p></p></li>
     <li><span>Change the value of <strong>BAR_BSALIB_PATH</strong>.</span><p></p>
      <ul>
       <li>For 1.5.0: Change the value of <strong>BAR_BSALIB_PATH</strong> to <span class="uicontrol"><b>/usr/openv/lib/libxbsa64iif.so</b></span>.<p>Example: <strong>BAR_BSALIB_PATH /usr/openv/lib/libxbsa64iif.so</strong>.</p></li>
       <li>For 1.6.0 and later versions: Change the value of <strong>BAR_BSALIB_PATH</strong> to <strong>/</strong><em>Parent directory where the client is installed</em><strong>/DataBackup/ProtectClient/interfaces/xbsa/lib/libxbsa64iif.so</strong>.<p>Example: <strong>BAR_BSALIB_PATH /opt/DataBackup/ProtectClient/interfaces/xbsa/lib/libxbsa64iif.so</strong>.</p></li>
      </ul> <p></p></li>
     <li><span>For a GBase 8s database, perform this step. Otherwise, skip this step.</span><p></p>
      <ol type="a">
       <li>Run the following command to view the server ID:<pre class="screen">cat /<em>Database installation directory</em>/etc/onconfig |grep SERVERNUM</pre> <p><span><img src="en-us_image_0000002164771562.png"></span></p>
        <div class="note">
         <img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span>
         <div class="notebody">
          <p>Replace <strong>onconfig</strong> with the actual name of the instance configuration file.</p>
         </div>
        </div></li>
       <li id="EN-US_TOPIC_0000002200098125__li68634264103"><a name="EN-US_TOPIC_0000002200098125__li68634264103"></a><a name="li68634264103"></a>Run the following command to check whether the instance is configured:<pre class="screen">cat /<em>Database installation directory</em>/etc/onconfig |grep ^BAR_IXBAR_PATH</pre> <p>If information similar to the following is displayed, the configuration is complete and no further action is required. Otherwise, proceed with the subsequent operations to configure the instance.</p> <pre class="screen">BAR_IXBSA_PATH /<em>Database installation directory</em>/backups/ixbar.<em>Server ID</em></pre></li>
       <li>Run the following command to configure the database instance:<pre class="screen">mkdir /<em>Database installation directory</em>/backups; onmode -wf BAR_IXBAR_PATH=/<em>Database installation directory</em>/backups/ixbar.<em>Server ID</em></pre></li>
       <li>Perform <a href="#EN-US_TOPIC_0000002200098125__li68634264103">6.b</a> to verify that the instance is successfully configured.</li>
      </ol> <p></p></li>
    </ol>
   </div>
  </div>
  <div>
   <div class="familylinks">
    <div class="parentlink">
     <strong>Parent topic:</strong> <a href="en-us_topic_0000002200012593.html">Backing Up Informix/GBase 8s</a>
    </div>
   </div>
  </div>
 </body>
</html>